*********************************
*   A n i D B - o - m a t i c   *
*                               *
*   adding to AniDB made easy   *
*                               *
*     Copyright (c) 2003 by     *
*        BennieB & PetriW       *
*********************************

AniDB O'Matic is meant to ease the handling of your AniDB anime collection.
Current major features:
  - Hash files with ed2k, crc32, md5 and sha1 at the same time while not affecting program performance.
  - Drag & Drop adding of hash files.
  - Get movie details on avi files.
  - Keep a local database of your hashed anime files
  - Ability to launch files directly from within the program
  - Integration with the AniDB database.

---------------------------------------------------------------------


      !!! NOTICE THIS README IS OUTDATED !!!!
(if you feel like contributing please help update it ;) )
      !!! NOTICE THIS README IS OUTDATED !!!!

Options:

  General
    "Verify local files on start up"
      Goes through your local files list on start up removing and/or
      rehashing invalid entries. (read below)
    "Automatically rehash updated files"
      If a file in your local files has been updated this will cause 
      it to be automatically added to the batch list for rehash.
    "Show folder size for local files"
      Shows an additional column in the local files detailing the size
      of all files below the current folder.
    "Hide root folder in local files"
      Hides the root folder in the local files view thus merging all 
      harddrives etc, this is especially useful if you have your anime
      collection spread over multiple drives.
    "Copy length as minutes"
      Copies movie length as minutes during extract operations, otherwise
      it'll be copied as "2 hours, 15 minutes, 39 seconds".
    "Automatically expand tree nodes"
      Automatically expands tree nodes as you naviage through them.
    "Automatically collapse tree nodes"
      Automatically collapses tree nodes as you naviage away from them.

    "Replace space in ed2k links" / "With"
      Sometimes it can be necessary to not include spaces in your ed2k
      links, use this option to replace spaces with a configurable string.

    "Language"
      Not implemented.


  Hashing
    "Integrate into shell"
      Adds a "Hash with AniDB O'Matic" to your explorer right click menu 
      for files and folders. NOTE: Please uncheck this box and apply settings
      if you remove the program or the option will remain forever.
    "Start hashing automatically"
      Automatically starts hashing of new files added to the batch list.
    "Use extension filter"
      Only adds files of the specified extensions to the batch list. These
      can be configured separatelly to the right. Add files WITHOUT the .
      ie, add extensions as "avi" or "mpeg".
    "Thread priority"
      Select a thread priority for the hashing thread, note that "Idle" and
      "Realtime" are discouraged for performance reasons.
    
    "Hash export settings"
      Here you can configure your own custom export format. Simply click the
      text labels to insert identifiers for generated data and write whatever
      else is needed around it.
      Samples:
        !addfile %fulled2k%
        File: %filename% - %size% - %length%

  Colors
    Under this page you can configure the color of rows show in the local 
    files. Left click on the panel to set the background color and right
    click to set the text color.

  Players
    Here you can add media players to launch/engueue files from within
    AOM. For example, this would be how you add "Zoom Player":
      Enter "Zoom Player" in the edit in the upper right corner and click "Add".
      Select the "Zoom Player" row in the Player list on the left.
      Click "Set as default". (Optional)
      Click "Browse..." and find the program location, for example:
        C:\Program Files\Zoom Player\zplayer.exe
      Write this in the Open parameter field:
        "%L"
      Write this in the Play parameter field:
        "/add:%L"
      Write this in the Enqueue parameter field:
        "/queue:%L"
      Now click ok and you can launch files with a right click in your 
      local files view.

    Note that %L is currently the only valid parsed parameter, this is
    replaced with the path and filename in long filename format.
    Also note that most applications require the %L to be enclosed in
    quotation marks, ie "%L".
     

  File renaming:

    Supported tags:
      %a          Anime name
      %acat       Anime category
      %ayear      Anime year
      %e          Episode name
      %ep         Episode number and version
      %epno       Episode number
      %epart      Episode part, only valid for movies
      %v          Version
      %g          Group name
      %lg         Full group name
      %crc32      CRC32 checksum
      %ed2k       ED2K checksum
      %sha1       SHA-1 checksum
      %md5        MD5 checksum


    Supported macros:
      %lower%text%/lower%      Converts text lowercase
      %upper%text%/upper%      Converts text uppercase
      %upfirst%text%/upfirst%  Make only first character in text uppercase
      %upwords%text%/upwords%  Make first character in each word in text uppercase

Suppose you want to have [%lg] in all your files where there is a group but not when there is none, normally you get a "[]" in your filename if there is no group. This is where the editable tags come in, here's a sample. Fill in the fields as below: 
1) Tag: %LG 
2) Pattern: [%lg] 
3) Click add. 
4) Change your [%lg] in your renaming pattern to %LG. 
My pattern looks like this "%a - %ep - %e %LG%CRC" where %LG = [%lg] and %CRC = {%crc32} 

You can also add multiple tags to a pattnern, for example: 
%CST = [%lg (%g)] 
If EITHER of the two is empty the whole subpattern will be skipped. 
Please notice that nesting subpatterns is unsupported, you can't for example use %LG = [%lg]%CRC

---------------------------------------------------------------------

You can provide parameters at the start of the program, either from
a command line or from third-party tools like TotalCommander.

Switches:

  /help
    Display this text.

  /batch "%L"
    This will add the referenced file or directory and start hashing. If
    the item is a directory with subfolders all subfolders will be added
    too, you can also either use the trailing "\" or leave it out.
    Examples:
      AOM /batch "C:\Anime\Last Exile\[Inf-AF-F]Last_EXILE_ep18[56CBBA24].avi"
        or
      AOM /batch "C:\Anime\Stellvia Of The Universe"

  /batchutf8 filecount "filename" "filename" "filename" etc...
    Allows you to open multiple files at once.
    First argument is the number of file names sent.
    Following arguments are utf8 encoded ucs2 filenames (aka filenames 
    obtained with W functions).
  
  /fullupdate
    This will clear your local cache (except known files and settings) on startup.

  /database filename
    This will use the specified file as your current database, this is good 
    if you have multiple users accounts using the same computer for example.


Remember to enclose parameters in "" when they contain spaces.

---------------------------------------------------------------------

Please remember to check the changelog from time to time.

Latest version can be found at:
  #aom on ChatSociety

Testers and other helpers
- Exp
- nwa
- PixelK
- theMug
- wahaha
